home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / mscn200.arc / MULTISCN.DOC < prev    next >
Text File  |  1990-04-22  |  12KB  |  310 lines
  1.         
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                             Multi-Screen (c)
  18.  
  19.                                Ver 2.00
  20.  
  21.                Copyright (c) 1989-1990, by Doug Feuerbach
  22.  
  23.                        Written by Doug Feuerbach
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                              1 - Preliminaries
  30.                              -----------------
  31.  
  32. 1.00 DISCLAIMER:
  33.      ~~~~~~~~~~~
  34.     Although this product has been subjected to extensive beta testing,
  35. I do not take any responsibility for damages that may result from its
  36. use.  If you use this product, you agree to take full responsibilty for
  37. any damages that may result to your property, or person.
  38.  
  39. 1.10 SHAREWARE AGREEMENT:
  40.      ~~~~~~~~~~~~~~~~~~~~
  41.     Multi-Screen, version 2.00 and higher, is distributed under the
  42. shareware concept.  You may freely use this product on a trial bases for
  43. two weeks; after which, you are required to register Multi-Screen for
  44. $5.00 (U.S only) if you wish to continue useing it.
  45.     After receipt of your payment, you will be sent, via FidoNet or
  46. U.S. mail, your personalized key to activate Multi-Screen's extended
  47. features.  All further releases of Multi-Screen will be compatable with
  48. your personalized key.  During this release, I will be living at another
  49. location for three months.  Time tables have been calculated as to when
  50. and where registration fees need to be sent.
  51.  
  52. 1.20 DISTRIBUTION:
  53.      ~~~~~~~~~~~~~
  54.     You may freely distribute this software so long as it is
  55. distributed in it's origonal ZIPed form (MULTISCN.EXE, MULTISCN.DOC,
  56. SCREENS.LST, plus any update files).  If you suspect any alterations
  57. to the documentation or code, please contact me at the address that
  58. later follows (see time/location tables at end of documentation).
  59.  
  60. 1.30 SUPPORT:
  61.      ~~~~~~~~
  62.     The latest version of Multi-Screen is always available on my
  63. board, The Event Horizon, and may be FREQed by requesting the mask
  64. file name 'MULTISCN.'  If you have any comments, questions, and the
  65. like, feel free to leave me mail via Fidonet (1:3615/3), U.S. mail, or
  66. call my board, and I will attempt to reply with all due haste (see
  67. time/location tables at end of documentation for this release).
  68.  
  69.        The Event Horizon                  Doug Feuerbach
  70.          (615)595-7717                    1629 W. Cumberland Ave
  71.    Fidonet Address: 1:3615/3              Clement Hall, Box 318
  72.         Hayes V.42 9600                   Knoxville, TN 37916
  73.  
  74.  
  75. 1.40 DISCRIPTION:
  76.      ~~~~~~~~~~~~
  77.     Most Bulletin Board Systems (henceforth refered to as BBSes) are
  78. limited to one "welcome" screen.  This limited diversity rapidly results
  79. in the user and SysOp always attempting to skip the "welcome" screen.
  80. Multi-Screen is a utility designed to allow *250*  "welcome" screens for
  81. a given BBS.  It may be run on a daily basis, via a system event (which
  82. will give the users a different screen to view each day), or for those
  83. who are running a of front-end mailer, it can be executed each time a
  84. user logs off (thus giving a new screen each time a new user logs on).
  85.  
  86. Page 1
  87.  
  88.  
  89.  
  90.                              2 - Initial Setup
  91.                              -----------------
  92.  
  93. 2.00 SETUP:
  94.      ~~~~~~
  95.     Multi-Screen may be run from any directory on your system, and
  96. on any drive.  It's initial setup is rather simple, and can be broken up
  97. into three basic.
  98.  
  99. 2.10 STEP I:
  100.      ~~~~~~~
  101.     Multi-Screen uses ANSI screens supplied by you, or the sample
  102. screens included in ZIPed archive.  The first thing you need to do is
  103. determine where on your hard drive(s) you wish to place these screens.
  104. I personally prefer a subdirectory in the main QuickBBS directory
  105. called 'ANSISCNS.'
  106.  
  107. 2.20 STEP II:
  108.      ~~~~~~~~
  109.     The second thing you will need to do is create a DOS text file
  110. called 'SCREENS.LST' which will have the FULL PATH AND NAME of each
  111. screen you wish Multi-Screen to use.  This text file, henceforth,
  112. shall be known as the Multi-Screen library.  The library must reside in
  113. the same directory as Multi-Screen.  An example SCREENS.LST has been
  114. provided in the ZIPed file.  Below are some other examples of
  115. SCREENS.LST.
  116.  
  117.                                 EXAMPLES:
  118.                                 ---------
  119.         C:\QUICKBBS\TXTFILES\WELCOME1.ANS  <- Beginning of SCREENS.LST
  120.         C:\QUICKBBS\TXTFILES\WELCOME2.ANS
  121.         C:\QUICKBBS\TXTFILES\STARTRK.ANS   <- End of SCREENS.LST
  122.  
  123.     Note that there are no exteraneous spaces at the beginning and end
  124. of the library (SCREENS.LST).  If you wish to add new screens, you may
  125. do so through means of your favorite text editor (QEdit!).
  126.  
  127. 2.20 STEP III:
  128.      ~~~~~~~~~
  129.     Lastly, you must create a DOS text file of the name MULTISCN.CFG.
  130. This file is what Multi-Screen refers to, when it checks if your copy is
  131. registered or not.  MULTISCN.CFG consists of three data lines.  The
  132. first is your name, the second line is the name of your BBS, and the
  133. third is some arbitrary number (zero?), unless you have registered your
  134. copy of Multi-Screen and have your personalized registration number.
  135. If you do have your personalized registration number, put it as the
  136. third line.  Once again, there may not be any exteraneous lines in
  137. MULTISCN.CFG.  Below is an example:
  138.  
  139.         Douglas Feuerbach  <-- First Name
  140.         The Event Horizon  <-- Name of your BBS
  141.         0                  <-- Registration number
  142.  
  143. Page 2
  144.  
  145.  
  146.  
  147.                        3 - Execution (Basic Operation)
  148.                        -------------------------------
  149.  
  150. 3.00 EXECUTION (Basic Operation):
  151.      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  152.     Multi-Screen may be executed daily (via a system event), or, if you
  153. are running a front end mailer (FrontDoor, BinkleyTerm, D'Bridge, et al),
  154. Multi-Screen may be executed before or after a user logs on or off
  155. respectivelty, in your batch file.
  156.     Multi-Screen should be called in the following manner.
  157.  
  158.         MULTISCN <Full Path and File Name of Your 'Welcome' Screen>
  159.  
  160.                                 EXAMPLE
  161.                                 -------
  162.         MULTISCN C:\QUICKBBS\TXTFILES\WELCOME.ANS
  163.  
  164.                 - WELCOME.ANS may be what ever file name your BBS uses
  165.                   as it's 'welcome' screen.
  166.  
  167.  
  168.                      4 - Execution (Extended Operations)
  169.                      -----------------------------------
  170.  
  171.  
  172. 4.00 EXTENDED FEATURES:
  173.      ~~~~~~~~~~~~~~~~~~
  174.     Multi-Screen offers another feature to those who have registered
  175. their copy (see REGISTRATION).  On a certian day, or period of days
  176. (hollidays, celebrations, etc.), you may wish to display only those ANSI
  177. screens which are associated with that day(s).  For example, if between
  178. December 1st and 26th (Christmas season) you might want to display only
  179. those ANSI screens representative of Christmas.  Multi-Screen allows you
  180. to do just that.  To do this, Multi-Screen will require the addition of
  181. another DOS text file, namely SCREENS.PCK, and sub-libraries (provided
  182. by you).
  183.  
  184. 4.10 SCREENS.PCK
  185.      ~~~~~~~~~~~
  186.     SCREENS.PCK must reside in the same directory as Multi-Screen.
  187. If SCREENS.PCK is not located in the same directory as Multi-Screen,
  188. Multi-Screen will operate in the 'Basic Operations' mode (described in
  189. section 3).  SCREENS.PCK is 'pick' file for the sub-libraries and must
  190. conform to a specific format described below.
  191.  
  192. 4.11 SCREENS.PCK format
  193.      ~~~~~~~~~~~~~~~~~~
  194.     SCREENS.PCK is a standard DOS text file and may be edited with your
  195. favorite text editor.  Each line in SCREENS.PCK consists of a 3 fields
  196. separated by a space: the START month and day, sub-library file name,
  197. and the STOP month and day.  The START date tells Multi-Screen when to
  198. begin useing the ANSI screens specified by the sub-library, the
  199. sub-library name field tells Multi-Screen the name of the sub-library to
  200. use, and the STOP date tells Multi-Screen when to stop using the
  201. sub-library.  There can be no exteraneous blank lines in SCREENS.PCK.
  202. SCREENS.PCK may be as long as you wish (on a 5.8 MHz machine,
  203. Multi-Screen will can scann 200 lines in 3.00 seconds).  The format is
  204. as below:
  205.  
  206. Page 3
  207.  
  208.  
  209.     Month-Day<space>sub-library_filename<space>Month-Day
  210.          ^                  ^              ^
  211.          ^--Dash Necessary  ^--Legal DOS   ^--Single Space
  212.                                Filename
  213.  
  214.     EXAMPLES
  215.     --------
  216.     4-13 easter.lst 4-15
  217.     12-1 christms.lst 12-26
  218.     12-27 newyear.lst 1-1
  219.     8-29 anvrsery.lst 8-29
  220.     12-26 newyear.lst 1-1
  221.  
  222. 4.12 SUB-LIBRARY format
  223.      ~~~~~~~~~~~~~~~~~~
  224.     The sub-library format has the exact same format as your SCREENS.LST
  225. main library.
  226.  
  227.  
  228.                         5 - Registering Multi-Screen
  229.                         ----------------------------
  230.  
  231. 5.00 REGISTRATION FEE
  232.      ~~~~~~~~~~~~~~~~
  233.     To register Multi-Screen, you must fill out the Registration Form
  234. provided at the end of the documentation, along with a check for $5.00
  235. (U.S) made out to Douglas Feuerbach.  Upon receipt of your registration,
  236. a 'key' to unlock the extended functions will be promptly sent to you via
  237. FidoNet mail, or the postal service.
  238.  
  239.  
  240.  
  241. WHAT'S COMMING IN Ver 2.50:
  242. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  243.     o   A windowed editor for the Multi-Screen librarys.  The ability to
  244.         list, view, and locate all ANSI screens in the main library
  245.         (SCREENS.LST) and in specified libraries (including start/stop
  246.         dates).
  247.     o   The option to call your favorite ANSI editor (TheDraw, etc.) if
  248.         you wish to edit a particular ANSI screen, from within the
  249.         Multi-Screen editor.
  250.     o   Other possible additions are being tossed around in the
  251.         proverbial think tank.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.                        Multi-Screen Registration Form
  258.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  259.  
  260. Name (Last, First M.I.)._______________________________________
  261.  
  262. Alias (if any).........._______________________________________
  263.  
  264. Street Address.........._______________________________________
  265.  
  266. City/Town..............._______________________________________
  267.  
  268. State/Province.........._______________________________________
  269.  
  270. Country................._______________________________________
  271.  
  272. Bulltetin Board Ph#.....(_____)_____-_____
  273.  
  274. FidoNet Address........._______________________________________
  275.  
  276.  
  277. The following must be exactly as you want it to appear on your copy of
  278. Multi-Screen:
  279.  
  280. Name...................._______________________________________
  281. Name of BBS............._______________________________________
  282.  
  283.  
  284.      Between April 22nd and August 15th, I can be reached at the FidoNet
  285. address 1:264/710, via NetMail.  A new version should be released when I
  286. return to Knoxville, TN (after Aug 15th) with my current FidoNet
  287. address.
  288.  
  289. SA
  290. ************************** Time/Location Table *******************************
  291. *                                                                            *
  292. *                                                                            *
  293. *    If you are registering after April 22nd and before August 15, 1990,     *
  294. *    send check and registration form to:                                    *
  295. *                                                                            *
  296. *                          1220 Giles Road                                   *
  297. *                          Blacksburg, VA  24060                             *
  298. *                                                                            *
  299. *                                                                            *
  300. *    To register after August 15, 1990 send check and registration form to   *
  301. *                                                                            *
  302. *                          1629 W. Cumberland Ave.                           *
  303. *                          Clement Hall Box 318                              *
  304. *                          Knoxville, TN  37916                              *
  305. *                                                                            *
  306. *                                                                            *
  307. *    Your registration number will be returned to you promptly               *
  308. *                                                                            *
  309. ******************************************************************************
  310.